DrawThemePopupArrow

Draws a pop-up arrow.



 
pascal OSStatus DrawThemePopupArrow (

                     const Rect *bounds,

                     ThemeArrowOrientation orientation,

                     ThemePopupArrowSize size,

                     ThemeDrawState state,

                     ThemeEraseUPP eraseProc,

                     UInt32 eraseData);

bounds: A pointer to a structure of type Rect . Before calling DrawThemePopupArrow , set the rectangle to contain the arrow, in local coordinates. DrawThemePopupArrow positions the arrow relative to the top left corner of the rectangle.
orientation: A value of type ThemeArrowOrientation . Pass a constant specifying the direction in which the pop-up arrow points. See Theme Pop-Up Arrow Orientation Constants for descriptions of possible values.
size: A value of type ThemePopupArrowSize . Pass a constant specifying the size of the pop-up arrow to draw. See Theme Pop-Up Arrow Size Constants for descriptions of possible values.
state: A value of type ThemeDrawState . Pass a constant specifying the current state of the button containing the pop-up arrow. See Theme Draw State Constants for descriptions of possible values.
eraseProc: A value of type ThemeEraseUPP . If you have a custom background, pass a universal procedure pointer to an application-defined function such as that described in MyThemeEraseProc . DrawThemePopupArrow calls that function to erase the background before drawing the pop-up arrow. If you pass NULL , no erasing occurs.
eraseData: An unsigned 32-bit integer. Provide any data to be passed in to the eraseData parameter of the callback function specified in the eraseProc parameter.
function result: A result code; see Result Codes .

DISCUSSION

The DrawThemePopupArrow function draws a theme-compliant pop-up arrow. A pop-up arrow is an image drawn onto another control to indicate that when the control is clicked, you get a pop-up menu. A pop-up arrow is not a separate button itself. Typically, a pop-up arrow is used in conjunction with a button, such as a push button or bevel button. Bevel button controls automatically draw a pop-up arrow if a menu is associated with the control.

VERSION NOTES

Available with Appearance Manager 1.1 and later.